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ABSTRACT 


NEATO is a program that makes layouts of undirected graphs following the filter model of 
DAG and DOT. Its layout heuristic creates virtual physical models and runs an iterative 
solver to find low energy configurations. The intended applications are in telecommunica- 
tion networks, computer programming and software engineering. Here is a sample layout 
depicting a typical entity-relationship database schema. It took 0.11 seconds of user time 
to generate on an HP-9000/730 computer. 
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1 Introduction 

NEATO is a utility that draws undirected graphs, that are common in telecommunications 
and computer programming. It draws a graph by constructing a virtual physical model 
and running an iterative solver to find a low-energy configuration. Following an approach 
proposed by Kamada and Kawai [KK89], an ideal spring is placed between every pair of 
nodes such that its length is set to the shortest path distance between the endpoints. The 
springs push the nodes so their geometric distance in the layout approximates their path 
distance in the graph. This often yields reasonable layouts [Ead84][FR91]. 

neato is compatible with the directed graph drawing program dot in sharing the same 
input file format and graphics drivers [KN91]. Since the file format includes both undirected 
and directed graphs, NEATO draws graphs prepared for DOT, and vice versa. Both programs 
have the same options for setting labels, colors, shapes, text fonts, and pagination, and for 
generating code in common graphics languages (presently PostScript, FrameMaker MIF, 
and HPGL/2). Both work with DOTTY, an interactive graph viewer for X windows. It may 
be reasonable to combine these programs eventually. 

Figs. 1-4 are representative examples of NEATO’s output. The timings refer to user time 
on an HP-9000/730 server. Fig. 1 was derived from a hand-made drawing in an operating 
system tutorial. Fig. 2 shows the connectivity of a computer network. Fig. 3 shows the 

graph G { 

run — intr; 
intr — runbl; 
runbl — run; 
run — kernel; 
kernel — zombie; 
kernel — sleep; 
kernel — runmem; 
sleep — swap; 
swap — runswap; 
runswap — new; 
runswap — runmem; 
new — runmem; 
sleep — runmem; 

> 

Figure 1: Process States in an Operating System Kernel (0.08 seconds) 
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sharing of programmer-defined types between procedures in a C program. The program 
that was the source of this graph parses a text file into an internal data structure. The 
graph was extracted from a C program database. Its drawing shows where interactions or 
conversions between types may occur. Finally, Fig. 4 shows relationships between IMRs 
shipped to the field in an externally released software product. 1 The labeled nodes are 
IMRs and the small circles reflect many-to-many dependencies. 



Figure 2: R&D Internet Backbone (0.35 seconds) 


1 Graph courtesy of J. Hoshen, Dept. 55554. 
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Figure 3: Type Sharing Between Procedures in a C Program (0.41 seconds) 



Figure 4: IMR Dependencies (44.1 seconds) 


neato User’s Manual, October 14, 1992 


neato User’s Guide 


4 



Figure 5: Example Graph Drawing 


2 Graph Drawing 

2.1 Basic Commands 

The remainder of this memo gives a synopsis of NEATO features. Many of these should be 
familiar to users of DOT. Fig. 5 shows a graph file, its drawing, and the command that 
was executed. A graph file has a short header and a body consisting of nodes, edges, and 
attribute assignments. By default, nodes axe drawn as ellipses labeled with node names. 
Undirected edges are created by the — operator. Edges are drawn as straight lines and 
tend to be all about the same length. 

2.2 Drawing Options 

Table 1 lists the graph, node and edge attributes that affect the layout. The options to set 
labels, shapes, fonts, and sizes are convenient for many kinds of layouts. The drawing in 
figure 6 illustrates some of these features. 2 Options to set the size of the drawing, pagination, 
and output graphics language are also the same as in DOT. 


3 Adjusting Layouts 

Although layouts made by neato are close to a local optimum as defined by the forces the 
springs exert on the nodes, fine tuning or generation of alternative layouts may improve 
readability. Because NEATO uses unconstrained optimization, it does not enforce mi nimum 
separation constraints between nodes or between edges and nonadjacent nodes, so in dense 
graphs nodes and edges can be too close or overlap. There are three ways of trying to 
correct these errors: 


2 Graph courtesy of Hector Zamora, DEFINITY. 
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1) change the initial configuration 

2) adjust the solver parameters 

3) edit the input edge lengths and weights. 

3.1 Initial Configuration 

If no options are given, neato always makes the same drawing of a given graph file, because 
its initial node placement and the solver are deterministic. Random initial placement can 
yield different layouts. It is sometimes reasonable to make at least several different trial 
layouts, and accept the best one. Random initial placement is requested by setting the 
value of the graph attribute start. If the value is a number, it is taken as a seed for the 
random number generator. The layout is different for each seed, but still deterministic. If 
the value is not a number, the process ID or current time is used. Each run potentially 
yields a different drawing. For example: 

$ neato -Tps -Gstart=rand file. dot > file.ps 

3.2 Termination Threshold 

The solver is a Newton-Raphson algorithm that moves a node with a maximal Se on every 
iteration. The solver terminates when 5e falls below some e. The default (.1) is low enough 
that the layout is usually close to a local minimum, but not so low that the solver runs for 
a long time without making significant progress. Smaller values of e allow the solver run 
longer and potentially give better layouts. Larger values can decrease neato’s running time 
but with a reduction in layout quality. This may be a desirable tradeoff for large graphs, e 
is set in the graph’s epsilon variable. It is convenient to do this on the command line: 

$ neato -Tps -Gepsilon=.001 small. dot -o small.ps 
$ neato -Tps -Gepsilon=l . 5 big. dot -o big.ps 


3.3 Edge Lengths and Weights 

Since the layout depends on the input edge lengths and their weights, these can sometimes 
be adjusted to good effect. The length of an edge is the preferred distance between the 
endpoint nodes. Its weight is the strength of the corresponding spring, and affects the 
cost if it is stretched or compressed. Invisible edges can also be inserted to adjust node 
placement. In figure 6, the length of some edges was set to 3 to make them longer than the 
default. Also, the two invisible edges affect Al, A2, and A3. 

There is also a way to also give the initial or final coordinates of individual nodes. The 
initial position, formatted as two comma-separated numbers, is entered in a node’s pos 
attribute. If ! is given as a suffix, the node is also pinned down. 
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graph G { 

nO — nl 
nl — n2 

> 



graph G { 
nO [ pos 
nl [ pos 
n2 [ pos 
nO — nl 


= " 0 , 0 !" 
= " 2 , 0 " ] 
= " 2 , 2 !" 
— n2 — 


]; 

> 

]; 

n3 — nO; 



Figure 8: Example graph with nodes pinned 


4 Future Work 


To improve clarity we would like to eliminate unintentionally overlapping nodes or edges. 
Such errors could be avoided by using constraints. Constraints could also offer users a 
natural way to adjust layouts. One concern in introducing constrained optimization is that 
we want to maintain interactive response time for moderate sized graphs. 

Another idea is to use a more straightforward layout heuristic based on graph topology. 
One approach often mentioned by researchers but seldom (if ever) implemented is to embed 
a maximal planar subgraph, then route any remaining edges heuristically. We also intend 
to eventually replace the straight line edges with splines that can bend around non-adjacent 
nodes or edge labels. 
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Name 

Default 

Values 

Node Attributes 

shape 

ellipse 

ellipse, box, circle, doublecircle, diamond, 



plaintext, record, polygon 

height, width 

.5, .75 

height and width in inches 

label 

node name 

any string 

f ontsize 

14 

point size of label 

f ontname 

Times -Roman 

font family name, e.g. Courier, Helvetica 

fontcolor 

black 

type face color 

style 


graphics options, e.g. bold, dotted, filled 

color 

black 

node shape color 

pos 


initial coordinates (append ! to pin node) 

Edge Attributes 

weight 

1.0 

strength of edge spring 

label 


label, if not empty 

f ontsize 

14 

point size of label 

f ontname 

Times -Roman 

font family name 

fontcolor 

black 

type face color 

style 


graphics options, e.g. bold, dotted, dashed 

color 

black 

edge stroke color 

len 

1.0 

preferred length of edge 

dir 

none 

forward, back, both, or none 

decorate 


if set, draws a line connecting labels with their edges 

id 


optional value to distinguish multiple edges 

Graph Attributes 

start 


seed for random number generator 

size 


drawing bounding box, in inches 

page 


unit of pagination, e.g. 8.5,11 

margin 

.5, .5 

margin included in page 

label 


caption for graph drawing 

f ontsize 

14 

point size of label 

f ontname 

Times-Roman 

font family name 

fontcolor 

black 

type face color 

orientation 

portrait 

may be set to landscape 

center 


when set, centers drawing on page 


Table 1: Drawing attributes 
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